home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / archives / com / internet / sting / sting.lzh / STING / dialer / docs / fee.doc next >
Text File  |  1997-08-18  |  4KB  |  81 lines
  1.  
  2.    The construction of a FEE file
  3.    ==============================
  4.  
  5. The Dialer for STinG is able to keep track of your cost due to Internet 
  6. connections. To incorporate the charge by your telephone company it needs 
  7. some information on their cost structure, which is stored in a *.FEE file.
  8. With that file the Dialer calculates the cost when `Disconnect' is clicked, 
  9. and writes it along with some other information into the DIAL.LOG file.
  10. Here is how to write such a *.FEE file.
  11.  
  12. Start an ASCII editor editing a file with the extension *.FEE. You begin 
  13. with the specification of the charge unit and it's cost using the `+e' and 
  14. `+u' command. The `+e' specifies the cost as a numerical number, the `+u' 
  15. specifies the unit. For instance the sample file `LOCAL.FEE' contains the 
  16. lines :
  17.            +e 0.12
  18.            +u DM
  19.  
  20. This means that the charge unit is DM 0.12 (Deutsche Mark). Use `+u $' in 
  21. the USA, `+u A$' in Australia, etc.
  22.  
  23. Now follows the big part with specifying the periods of time which lead to 
  24. the various connection lengths of the charge unit. It has the following 
  25. structure :
  26.  
  27. +1
  28. [time information]
  29. +2
  30. [time information]
  31. +3
  32. [time information]
  33. ...
  34. +n
  35. [time information]
  36.  
  37. There is no restriction on the number of time informations, or connection 
  38. lengths n. The time information itself consists of any number of lines, 
  39. each specifying a time interval that leads to the corresponding unit length. 
  40. Each line consists of three entries : A description of the day, the beginning 
  41. time and the ending time, separated by one or more spaces. The time entries 
  42. consist simply of the hour (24 hours clock !) and the minute, separated by 
  43. a colon `:'. The day description can have a number of different formats :
  44.  
  45.  * It can be simply the date : <day>.<month>.             (Priority 3)
  46.  * It can be deduced from Easter sunday (`E') or the First Advent (`A'),
  47.      by adding a number specifying how many days to add.  (Priority 2)
  48.  * It can be deduced from each sunday (`w') by adding a number specifying
  49.      the weekday this way (i.e. Wednesday is `w(3)' ).    (Priority 1)
  50.  * It can be deduced from the first day of each month (`m') by adding a 
  51.      number, m(2) would match Jan, 3rd; Feb, 3rd; etc.    (Priority 1)
  52.  * It can denote simply every day (`a').                  (Priority 0)
  53.  
  54. The priority is needed for the case that there are conflicting entries. 
  55. For instance some country could have a public holiday on May 27th, the 
  56. phone company has reduced cost for this day, and the same for Whitsun 
  57. monday. So a user in that country would have two different lines for each 
  58. day :
  59.   ...
  60.   27.5.  5:00  21:00            Holiday tariff from 5 am to 9 pm.
  61.   ...
  62.   E(50)  9:00  18:00            Whitsun tariff from 9 am to 6 pm.
  63.   ...
  64. In the year 1997 it happens that Whitsun monday _is_ the 27th of May ! 
  65. In that case the line starting with `27.5.' prevails because it has the 
  66. higher priority (3, while `E(50)' has priority 2).
  67.  
  68. Another single line is needed now for specifying the connection lengths 
  69. per charge unit :
  70.  
  71. # <unit length for +1> ... <unit length for +n> <tariff name>
  72.  
  73. Precisely n unit lengths must be given, each one consisting of a number, 
  74. followed by a unit `s', `m' or `h' for seconds, minutes and hours, 
  75. respectively. No space must be used between the number and the unit. A 
  76. string may follow that is included into the corresponding DIAL.LOG entry.
  77. Normally this should be the tariff name.
  78.  
  79. For a sample *.FEE see the LOCAL.FEE which is provided with the Dialer 
  80. package.
  81.